PROGRAMMING SPECIFICATIONS 



CREF 
INPUT FORMATS FOR CREF 



| Date: l-July-75 

File; CREF.RNO 
| Edition: 3 



The information in this document is subject to change without notice 
and should not be construed as a commitment by Digital Equipment 
Corporation. Digital Equipment Corporation assumes no responsibility 
for any errors that may appear in this manual. 

The software described in this document is furnished to the purchaser 
under a license for use on a single computer system and can be copied 
(with inclusion of DIGITAL'S copyright notice) only for use in such 
system, except as may otherwise be provided in writing by DIGITAL. 

Digital Equipment Corporation assumes no responsibility for the use or 
reliability of its software on equipment that is not supplied by 
DIGITAL. 



CREF 

1 . INTRODUCTION 

Two input formats are acceptable to CREF. The first is 
produced by early versions of MACRO (prior to version 30), 
the PALX assembler for the PDP-8, and early versions of F44 
(prior to version 06) . The second input format for CREF is 
produced by current versions of MACRO (version 30 and 
later) , version 06 and later of F40, the Stanford FAIL 
assembler, version 6 and later of ALGOL, and version 4 and 
later of FORTRAN-10. 



2.0 EARLY INPUT FORMAT 

The codes listed below are produced by the early versions of 
MACRO and F40 as input to CREF. They are ignored by CREF if 
they contain control characters from current versions of 
MACRO and FORTRAN. 

ASCII Code Meaning 



33 Indicates that the code type 
is an op code, a pseudo-op 
code, or an op code that the 
user has defined with OPDEF. 

34 Indicates that the code type 
is a macro name. 

35 Indicates the end of line. 

36 Indicates a normal symbol; 
i.e., a symbol defined with an 
equal sign (■) or a colon (:). 

37 Indicates a program break 
between F40 subroutines. 

This input format to CREF should not be used when new 
programs are being developed. 



3.0 CURRENT INPUT FORMAT 

The control characters described below appear in the CREF 
input file produced by MACRO and FORTRAN. 

On each line of the listing, CREF input data are enclosed by 
RUBOUT B and RUBOUT C. The symbols or instruction types, 
and the number of their component characters are defined by 
control characters. The set of control characters defining 
symbols and instructions is the same as the set defining the 
number of symbol or instruction characters. A control 
character's position determines its function. For example, 
in the input CREF data B*C*CENDC, the B indicates the 
beginning of the data, the first *C defines the instruction 
END as a pseudo-op code, the second "C defines the number of 
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characters in the instruction END as 3, and the C terminates 
the CREF data. The control characters and their meanings 
are described below. 



3.1 Beginning and Ending Control Characters 

The control characters that begin and end 
data are: 



the CREF input 



RUBOUT B (prints as B) 

RUBOUT C (prints as C) 
RUBOUT F 

RUBOUT A (prints as A) 

RUBOUT D 

RUBOUT E (prints as E) 



which signals the beginning of 
the CREF data on each line, 

which terminates the CREF data 
on each line, 

which is identical to RUBOUT 
C, except that RUBOUT F does 
not increment or print line 
numbers. 

which terminates the CREF data 
on each line and adds a 
horizontal tab to the line of 
the listing, and 

which is identical to RUBOUT 
A, except that RUBOUT D does 
not increment or print line 
numbers. 



which marks a break 
FORTRAN subroutines. 



between 



3.2 Symbol-Definition Control Characters 

These control characters define symbols, instruction types, 
and macros: 



Character 



ASCII Code 



Meaning 



CONTROL-A CA) 



001 



CONTROL-B TB) 



002 



Precedes every occurrence 
of each symbol in the 
listing defined with an 
equals sign (*) or a 
colon ( :) . 

Immediately follows a 
symbol in the listing 
defined with an equals 
sign or colon. 
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CONTROL-C (*C) 

CONTROL-D (*D) 

CONTROL-E (~E) 

CONTROL-F (~F) 

CONTROL-G (*G) 

CONTROL-H (*H) 



CONTROL-I (*I) 

CONTROL-J ("J) 

CONTROL-K CK) 

CONTROL-L (*L) 

CONTROL-M (*M) 

CONTROL-N (*N) 

CONTROL-0 CO) 



003 

004 

005 
006 

007 

010 



Precedes an op code 
(whether hardware- or 
OPDEF-defined) or a 
pseudo-op code. 



011 

012 
013 

014 
015 

016 

017 



Precedes an op 
defined by OPDEF. 



code 



Precedes a macro call. 

Precedes the definition 
of a macro. 

Causes CREF to delete the 
last symbol that it read. 

Combines two symbols that 
are defined at different 
block levels and are then 
discovered to be the 
same. For example, the 
combination occurs when 
FAIL exits the 
block — provided that the 
inner-block symbol has 
not been defined before 
exit. 

Defines the symbol by 
giving it a name in place 
of the unique numeric. 

Illegal in CREF. 

Works exactly like 011 
(*I) , except that it 
operates on macros rather 
than on symbols. 

Illegal in CREF. 

Signals the beginning of 
a symbol block. The 
argument is the 
blockname. 

Signals the end of a 

symbol block. The 

argument is the 
blockname. 

Allows the compiler to 
input a line number not 
output by CREF. 
Thereafter, CREF assigns 
to this line number all 
information that it 
extracts from the source 
file. 
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Although CREF recognizes and accepts all of the above 
control characters, current versions of MACRO do not produce 
all of these characters. As shown in paragraph 3.0, CREF 
recognizes a symbol defined by OPDEF as an op code because 
"D precedes its definition, and because "C precedes its use. 

MACRO treats symbols defined by OPDEF as macros, and 
precedes these symbols by A F when they are defined and by ~E 
when they are used. Because MACRO has produced their 
control characters, CREF also treats these symbols as 
macros. But CREF's treatment of symbols defined by OPDEF as 
macros has no effect on cross-referencing, because OPDEF and 
macro symbols are grouped into the same table. 



3.3 Character-Count-Definition Control Characters 



The octal value of the control char 
used by CREF to determine the 
symbol or instruction. The same se 
defines the symbol as well as its n 
control character's position determ 
character-count control character 
symbol with no intervening space 
"CEND) . The control characters 
follows: 



acters described below is 
number of characters in a 
t of control characters 
umber of characters. The 
ines its function. The 
immediately precedes the 
s or characters (e.g., 
and their meanings are as 



Character 


TA) 


&SCII Code 


CONTROL-A 


001 


CONTROL-B 


TB) 


002 


CONTROL-C 


CC) 


003 


CONTROL-D 


(~d) 


004 


CONTROL-E 


Te) 


005 


CONTROL-F 


Tf) 


006 



Meaning 



The symbol contains 1 
character . 

The symbol contains 2 
characters. 

The symbol contains 3 
characters. 

The symbol contains 4 
characters. 

The symbol contains 5 
characters. 

The symbol contains 6 
characters. 



100(8) The symbol contains 64 
characters. 
No symbol or instruction can contain more than sixty-four 
octal characters. 
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3.4 Example of the Current Input Format 



The example below shows a small MACRO program 
listing produced by MACRO to be input to CREF. 



and the 



(CREF SPECIAL CHARACTER DEMONSTRATION 
HACRO 44.0 09:30 10-OEC-70 PAGE 1 



(CREF SPECIAL CHARACTER DEMONSTRATION 



FOOl 



M-S 

MOVE I M 



SIXBIT/123/ 



MOVEI 6+FOO 
OPDEP TTYCAL [51811] 
DEFINE TEST (X) <TLNE X> 

TTYCAL 

TEST M 

END 



>1 CHAR SYMBOL DEFINITION 

lS CHARACTER OPCODE 

;1 CHAR SYMBOL USE 

;3 CHAR SYMBOL DEFINITION 

(6 CHAR PSEUDO INSTRUCTION 

I MORE OF THE ABOVE 

(OPCODE DEFINITION 

; MACRO DEFINTION 

(OPCODE USE 

(MACRO CALL & SYMBOL USE 

(PSEUDO INSTRUCTION OCCURRENCE 



MACRO 44 
.MAC 



09(30 10-DEC-70 PAGE 1 



000000' 



.MAIN 

TEST 

BC 

B*A"AM"BC 

B"C*EMOVEI"A*AMC 

BC 

B*A"CFOO*B*C*FSIXBITC 

BC 

B*C*EMOVEI*A*CFOOC 

B*C*EOPDEF*F*FTTYCALC 

B*C*FDEFINE*F*DTESTC 

B'E'FTTYCALC 000003 

B*E*STESTC 

B'C'DTLNE'A'ANC 000004' 603000 

B'C'CENDC 

NO ERRORS DETECTED 

PROGRAM BREAK IS 000005 

2K CORE USED 

.MAIN MACRO 44.0 09:30 10-DEC 

TEST .MAC SYMBOL TABLE 

POO 000001' 

M 000006 

TTYCAL 005100 000000 



000006 
201000 



000001' 212223 
000002' 201000 



005100 000000 



(CREF SPECIAL CHARACTER DEMONSTRATION 

H-6 ;1 CHAR SYMBOL DEFINITION 

000006 MOVEI M »5 CHARACTER OPCODE 

(1 CHAR SYMBOL USE 

000000 FOO: SIXBIT /123/ (3 CHAR SYMBOL DEFINITION 

(6 CHAR PSEUDO INSTRUCTION 

000007' MOVEI 6+FOO (MORE OF THE ABOVE 

OPDEF TTYCAL [51B11] (OPCODE DEFINITION 

DEFINE TEST (X) <TLME X) (MACRO DEFINITION 

TTYCAL (OPCODE USE 

TEST M (MACRO CALL t SYMBOL USE 
0000006 TLNE M 

END (PSEUDO INSTRUCTION OCCURRENCE 



-70 PAGE 2 



